<!DOCTYPE html PUBLIC 
    "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Документация к "Панель управления администратора почтового домена. ППриложения."</title>
<link rel="stylesheet" type="text/css" media="screen" href="docs.css" mce_href="docs.css" />
</head>
<body>
<h1>4. Приложения</h1>
<a name="1"></a><h2>Приложение I. Типы реакции на спам</h2>
<p>Действие (реакция) фильтра на факт классификации сообщения как "Спам" задается на трех уровнях.
Перечислим эти уровни в порядке убывания приоритета.</p>
<table>
<tr><td style="width:170px; vertical-align:top;"><b>Уровень пользователя</b></td><td>Если реакция на спам задана для конкретного пользователя
домена, то это указание имеет самый высокий приоритет. Ее можно задать используя пункт меню "АнтиСпам фильтр/Пользователи домена".<br></td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Уровень домена</b></td><td>Если для пользователя домена не задана конкретный тип реакции на спам,
(По умолчанию) то будет использован тип указанный для домена вцелом. Указать этот тип можно используя пункт "АнтиСпам фильтр/Опции фильтра".<br></td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Уровень фильтра</b></td><td>Используется только в том случае, если реакция на спам не была задана
на двух более высоких уровнях. Этот тип устанавливается администратором фильтра и как правило установлен в значение "Отвергнуть сообщение".<br></td></tr>
</table>
При настройке можно задать следующие типы реакции на спам:
<table>
<tr><td style="width:170px; vertical-align:top;"><b>По умолчанию</b></td><td>В этом случае будет использована настройка более низкого уровня. См. предыдущий параграф.<br></td></tr>
<tr><td style="width:150px; vertical-align:top;"><b>Принять</b></td><td>При выборе этого типа реакции фильтр кроме регистрации факта получения ничего не делает.
Фактически это аналогично отключению фильтра для конкретного пользователя, либо домена вцелом.<br></td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Перенаправить/Маркировать</b></td><td>Этот тип реакции указывает, что сообщение опознанное как "Спам" должно быть 
принято, но в последующем либо маркировано и доставлено получателю, либо перенаправлено на конкретно указанный (выделенный) адрес в том же домене. Более детальную информацию по этому типу
реакции на "Спам" смотрите в <a href="antispam.html#options">Опции фильтра.</a><br></td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Отвергнуть</b></td><td>В даном случае предусматривается, что спам-сообщение должно быть отвергнуто. Это значит, что
целевой получатель сообщения никак не будет информирован о попытке доставки сообщения. А отправитель сообщения может получить уведомление, о том, что его сообщение
классифицировано как "Спам"<br></td></tr>
</table>

<br /><a name="2"></a><h2>Приложение II. Работа с таблицами</h2>
<p>
    Большинство операций по настройке фильтра связано с редактированием различных списков. В данном приложении эти списки представлены в виде таблиц. 
Таблица содержит непосредственно саму таблицу ( заголовок, заголовки столбцов, столбцы, строки ), верхнюю панель инструментов ( панель операций ), панель навигации,
совмещенную в нижней панелью инструментов и панель фильтра. 
</p>
<p>
    Типичный вид таблицы показан на рис.__. Рассмотрим более детально ее составляющие.
</p>
<center><img src="images/wfrom.png"><br><b>Рисунок __</b></center>

<h3>Панель инструментов (Операции)</h3>
<p>Расположена в верхней части таблицы, над заголовками столбцов. Содержит следующие кнопки.</p>
<table>
<tr><td style="width:100px; vertical-align:top;"><b>Добавить</b></td><td>Добавление в таблицу новой записи.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><b>Изменить</b></td><td>Изменить, отредактировать существующую запись.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><b>Удалить</b></td><td>Удалить одну или несколько записей.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><b>Экспорт</b><td>Экспорт таблицы в Excel файл.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><b>Импорт</b></td><td>Импорт таблицы из Excel файла. См.<a href="appendix.html#10">Формат и структура файла импорта.</a></td></tr>
</table>

<h3>Панель инструментов (Управление отображением)</h3>
<p>Совмещена с панелью навигации и расположена в самой нижней части таблицы, слева. Содержит следующие кнопки.</p>
<table>
<tr><td style="width:100px; vertical-align:top;"><strong>Обновить</strong></td><td>Обновить отображение таблицы.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Столбцы</strong></td><td>Выбор столбцов для показа.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Фильтр</strong></td><td>Включить/Выключить панель фильтра. 
ЗАМЕЧАНИЕ.Выключение панели фильтра не удаляет ранее установленного фильтра.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Сохранить</strong><td>Сохранить настройки отображения таблицы. Сохранению подлежат следующие параметры: перечень отображаемых столбцов,
их порядок следования, ширина, столбец и направление сортировки, установленное для отображения количество строк таблицы, текущая страница, состояние панели фильтра (Вкл./Выкл.).
Эти данные сохраняются на сервере и будут восстановлены при последующих входах в систему администрирования.</td></tr>
</table>
<h3>Панель навигации по списку</h3>
<p>
    Расположена в самой нижней части таблицы, посредине. Содержит следующие элементы в порядке их следования слева-направо.
</p>
<ul>
<li>Кнопка перехода на первую страницу списка.</li>
<li>Кнопка перехода на предидущую страницу списка.</li>
<li>Элемент ввода номера страницы для прямого доступа к странице.</li>
<li>Кнопка перехода на следующую страницу списка.</li>
<li>Кнопка перехода на последнюю страницу списка.</li>
<li>Элемент выбора количества отображаемых строк на странице (таблице).</li>
</ul>

<h3>Панель фильтра</h3>
<p>Служит для отбора записей в списке для отображения в таблице и допустима не более чем по трем, одновременно заданым параметрам. Алгоритм отбора записей можно представить в следующем виде:</p>
<br>
<code>ПАРАМЕТР1 Содержит "Значение1" [ И [ ПАРАМЕТР2 Содержит "Значение2" [ И ПАРАМЕТР3 Содержит "Значение3"]]]</code><br>
<br>
Символы  "[" и "]" используются для показа необязательной части условия фильтра.

<h3>Неочевидные особенности, возможности</h3>
<p>
    Ниже приведен список основных неочевидных, на наш взгляд, особенностей и возможностей при работе с таблицей.
</p>
<ul>
<li><strong>Редактировать</strong> запись можно либо пометив ее и нажав кнопку "Изменить", либо сделать двойной щелчек мышью на записи. При этом запись будет 
переведена в режим "строчного" редактирования.</li>
<li><strong>Широну колонки</strong> можно изменить наведя указатель мыши на разделитель колонок в заголовке и нажав левую кнопку. При перемещении в таком положении указателя мыши будет
изменяться ширина соседствующих колонок.</li>
<li><strong>Расположение колонки</strong> в таблице можно изменить наведя указатель мыши на заголовок колонки и нажав левую кнопку. При перемещении влево/вправо указателя мыши будет
изменено расположение колонки в таблице.</li>
<li><strong>Порядок сортировки</strong> в таблице можно изменить наведя указатель мыши на заголовок выбраной для сортировки колонки и щелкнув по левой кнопке мыши.
Повторный щелчек выполнит переключение сортировки по возрастанию/убыванию.</li>
<li><strong>Фильтрация</strong> записей в списке для отображения в таблице допустима не более чем по трем заданым столбцам.
Повторный щелчек выполнит переключение сортировки по возрастанию/убыванию.</li>
</ul>

<br><a name="3"></a><h2>Приложение III. E-Mail адреса, доменные имена и их шаблоны</h2>
<p>
Требования к записи E-Mail адресов, доменных имен, подсетей в CIDR нотации описаны в соответствующих документах
<a target="_blank" href="http://tools.ietf.org/html/">RFC</a> и на их рассмотрении мы
останавливаться не будем. Здесь же, мы рассмотрим используемое в приложении понятие шаблона e-mail адреса, доменного имени и то, как данный шаблон интерпретируется фильтром.
</p>
<p>
Как известно, E-Mail адрес имеет вид:<code> local-part@example.domain.com</code><br>
<dl>
<dt>Здесь:</dt>
    <dd><code> local-part </code>- Локальная часть адреса</dd>
    <dd><code>example.domain.com</code> - доменное имя</dd>
</dl>
Запись доменного имени аналогична и для понятий домен, имя релея.
</p>
<p>Шаблоны предполагают наличие метасимволов. В нашем приложении этими метасимволами являются:</p>
<table>
<tr><td style="width:20px; vertical-align:top;"><strong>!</strong></td><td>Обозначает наличие в этом месте "цифры".</td></tr>
<tr><td style="width:20px; vertical-align:top;"><strong>*</strong></td><td>Обозначает наличие в этом месте "буквы".</td></tr>
<tr><td style="width:20px; vertical-align:top;"><strong>?</strong></td><td>В этом месте может присутствовать любой символ.</td></tr>
</table>

<h3>Шаблоны E-Mail адресов</h3>
<p>При получении очередного сообщения фильтр сравнивает соответствующие этому сообщению адреса со списками исключений, например списком "Белых адресов". Это сравнениение происходит
следующим образом.</p>
<p>Если запись адреса в списке содержит знак "@" и ему предшествует хотя бы один символ, то сравнение идет посимвольно. Т.е. запись в списке соответствует анализируемому адресу только
в том случае, если они полностью совпадают ( без учета регистра).</p>
<p>Если запись адреса в списке начинается со знака "@" или этот знак вообще отсутствует, то это запись шаблона и сравнение ведется начиная с конца и с учетом метасимволов.</p>
<p>Таким образом, записи в списке исключений: <code>user.name@example.company.com</code> соответствует только адрес: user.name@example.company.com.</p>
<p>Для шаблонов же возможны множественные значения. Например:<br>
<dl>
<dt>Шаблону <code>@example.company.com</code> будут соответствовать адреса</dt>
    <dd><code>a@example.company.com</code></dd>
    <dd><code>qwe-1.234.rty.asdfgh.zxcv1_0123@example.company.com</code></dd>
    <dd><code>Здесь_может_быть_все_что_угодно@example.company.com</code></dd>
<dt>Шаблону <code>.company.com</code> будут соответствовать адреса</dt>
    <dd><code>any_local_part@any-subdomain-1.company.com</code></dd>
    <dd><code>any_local_part@any-subdomain-2.company.com</code></dd>
    <dd><code>Здесь_может_быть_все_что_@угодно.company.com</code></dd>
<dt>Шаблону <code>@office-!!.company.com</code> будут соответствовать адреса</dt>
    <dd><code>any_local_part@office-01.company.com</code></dd>
    <dd><code>any_local_part@office-02.company.com</code></dd>
    <dd><code>any_local_part@office-99.company.com</code></dd>
</dl>
</p>
<h3>Шаблоны доменных имен (имен релеев)</h3>
<p>
Для доменных имен справедливо все, что было сказано о "Шаблонах E-Mail адресов", исключая моменты связанные с наличием символа "@". Приведем только несколько примеров.
<dl>
<dt>Шаблону доменного имени <code>.company.com</code> будут соответствовать имена релеев</dt>
    <dd><code>any-hostname-1.company.com</code></dd>
    <dd><code>any-hostname-2.company.com</code></dd>
    <dd><code>Здесь_может_быть_все_что_угодно.company.com</code></dd>
<dt>Шаблону доменного имени <code>mx!!.company.com</code> будут соответствовать имена релеев</dt>
    <dd><code>mx01.company.com</code></dd>
    <dd><code>mx02.company.com</code></dd>
    <dd><code>mx99.company.com</code></dd>
</dl>
</p>

<br><a name="4"></a><h2>Приложение IV. Определение терминов</h2>
<p>
Для большинства используемых в данном документе терминов можно найти толкование на сайте <a target="_blank" href="http://ru.wikipedia.org/wiki/">WikiPedia</a>,
строгое их описание можно найти в документах <a target="_blank" href="http://tools.ietf.org/html/">RFC(Request For Comments)</a>. Мы же, дадим краткое описание
некоторых, используемых в нашем толковании терминов.
</p>
<table>
<tr><td style="width:170px; vertical-align:top;"><b>Имя релея</b></td><td>Это доменнон имя <a target="_blank" href="http://ru.wikipedia.org/wiki/Релей">релея (промежуточного сервера)</a>,
определяемое на основе <a target="_blank" href="http://ru.wikipedia.org/wiki/Обратный_запрос_DNS">PTR записи</a> в системе 
<a target="_blank" href="http://ru.wikipedia.org/wiki/DNS">DNS</a>.<br>&nbsp;</td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>SMTP сессия</b></td><td>Это совокупность обмена последовательностями "Команда"-"Ответ" по протоколу <a target="_blank" href="http://ru.wikipedia.org/wiki/SMTP">
SMTP</a> между серверами, учавствующими в процессе передачи сообщений электронной почты на протяжении одного TCP/IP соединения. В процессе SMTP сессии может быть передано одно
или несколько сообщений электронной почты. С каждым сообщением асоциирован один адрес отправителя и один или несколько адресов получателя.<br>&nbsp;</td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Отправитель</b></td><td>E-Mail адрес отправителя почтового сообщения, полученный от удаленного релея, в процессе передачи сообщения. 
В общем случае этот адрес не обязательно совпадает с отображаемым в письме адресом поля "От: "(From:), которое содержится в заголовке сообщения. Часто этот адрес в самом сообщении 
(его заголовке) никак не фиксируется и его наличие там зависит от применяемого программного обеспечения и его настройки. В сообщениях, прошедших через наши сервера этот адрес
зафиксирован в поле "X-Envelope-From:" заголовка сообщения.<br>&nbsp;</td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Получатель</b></td><td>E-Mail адрес получателя почтового сообщения, полученный от удаленного релея, в процессе передачи сообщения. 
В общем случае этот адрес не обязательно совпадает с отображаемым в письме адресом поля "Кому: "(To:), которое содержится в заголовке сообщения. Часто этот адрес в самом сообщении 
(его заголовке) никак не фиксируется и его наличие там зависит от применяемого программного обеспечения и его настройки. В сообщениях, прошедших через наши сервера этот адрес
зафиксирован в поле "X-Envelope-To:" заголовка сообщения.<br>&nbsp;</td></tr>
</table>

<br><a name="10"></a><h2>Приложение X. Формат и структура файла импорта</h2>
<p>
При импорте списков из клиентского файла в базу данных сервера поддерживаются следующие форматы файлов: Excel5, Excel2003XML, Excel2007.<br>
ЗАМЕЧАНИЕ. Экспорт выполняется в формате Excel5.<br>
Для примера на рис.__ показана структура файла для импорта в список "Пользователи домена".
</p>
<center><img src="images/import.png"><br><b>Рисунок __</b></center>
<p>
Что здесь важно? Прежде всего формат и содержание заголовка таблицы. Положение заголовка можно изменять как по горизонтали так и по вертикали.
Все, что находится непосредственно под заголовком воспринимается как содержимое для импорта. Все, что располагается не непосредственно под заголовком при импорте отбрасывается. 
Игнорируются также пустые строки под заголовком, как например строки 11 и 25 на показанном рисунке.
</p>
</body>
</html>
